Skip to content

feat(ipmctl): add pinned Debian 13 source installer - #2

Closed
climateamante wants to merge 1 commit into
mainfrom
rewrite/ipmctl-simple
Closed

climateamante wants to merge 1 commit into
mainfrom
rewrite/ipmctl-simple

Conversation

@climateamante

Copy link
Copy Markdown
Contributor

Purpose

Install Intel's final ipmctl CLI on stock Debian 13 Trixie for Intel Optane Persistent Memory, including PMem 200, without turning GitHub Actions into an archived-source maintenance pipeline.

Debian 13 does not ship an ipmctl package. Intel archived the upstream project and does not promise further fixes or releases. This candidate therefore pins one downstream-reviewed source tuple and publishes a target-host installer plus read-only verifier. It supersedes the implementation direction in #1 only after the target-host acceptance below is complete; PR #1 remains unchanged for historical evidence.

Exact source policy

  • ipmctl v03.00.00.0538
    • commit a71f2fb1c90dd07f9862b71c789881132193e8f9
    • required installed version 03.00.00.0538
  • EDK2 edk2-stable202511
    • commit 46548b1adac82211d8d11da12dd914f41e7aa775
  • Debian 13 amd64
  • stock /usr/bin/cmake, Release build, two build jobs
  • install prefix /usr/local

The finite compatibility pack follows the reviewed meta-intel recipe:

  1. EDK2 stable-202511 host OS/unit-test guards, regenerated as an exact binary Git delta to preserve the pinned CRLF Base.h blob: ac6f0ea143c357c582135472defe8e936a63d7997221a29d4d0e4c349d7ac013.
  2. Remove -Werror from C Release flags while retaining C++ Release -Werror: d1928dc874219578abbc9eab5cc7a826ccf88457bd148f268aff367d134321b8.
  3. Remove executable-only -pie from shared-library linker flags: f926a6b07ad33b09f09032e6fd06a9229855d9d0501cfc7e67ecbb4c3c28a031.

Each patch is vendored with provenance and checked for checksum, sole target, exact preimage, strict applicability, reverse applicability, exact postimage, and a clean Git diff. The installer does not invoke Intel's drifting patch_OS.sh or updateedk.sh, use permissive patch flags, discover patches online, or patch compiler warnings one at a time.

Public behavior

wget -qO- https://devs-guide.github.io/debian/setup/cli/ipmctl.sh |
  bash -s -- install

wget -qO- https://devs-guide.github.io/debian/setup/cli/ipmctl.sh |
  sudo bash -s -- verify

install stages the published Ansible files, installs only the opt-in build dependency group, fetches exact tags, builds as the invoking user under ~/.cache/devs-guide/ipmctl, and uses privilege only for packages, CMake installation, ldconfig, and the small receipt under /var/lib/devs-guide/ipmctl.

verify requires the exact version and complete runtime linkage, then independently reports:

  • show -a -dimm
  • show -topology
  • show -memoryresources
  • show -a -goal

Exit 1 means software failure; exit 2 means software installed but hardware output still needs review. The wrapper never creates/deletes goals, changes firmware or security state, formats DIMMs, manages namespaces, or reboots. The installed CLI itself remains powerful; destructive commands are manual, outside this automation, and require separate review.

Simplification

  • removes the hosted ipmctl source-build job and source-network verification;
  • removes goal mutation, inventory normalization, the large ipmctl facts schema, compatibility matrix, helpers, and fixture corpus;
  • reduces the public interface to install and verify;
  • changes LLM-host ipmctl requirements to live version/Memory Mode evidence and diagnostic goal output;
  • keeps pull-request static validation and Pages assembly;
  • grants contents: write only to main-branch deployment; and
  • never deploys from this pull request.

Required acceptance before merge

GitHub automation is intentionally limited to repository contracts and static-site assembly. It does not compile ipmctl or claim PMem hardware readiness.

  • GitHub static validation succeeds.
  • The intended Debian 13 amd64 PMem-200 server fetches this exact candidate commit f2b4122.
  • bash setup/cli/ipmctl.sh install succeeds with stock Trixie GCC/G++/CMake.
  • /usr/local/bin/ipmctl version reports exactly 03.00.00.0538.
  • ldd /usr/local/bin/ipmctl has no unresolved entry.
  • The receipt and CMake install manifest contain the reviewed provenance.
  • All four read-only probe outputs are retained and accepted by a human reviewer.
  • A second install validates the receipt/binary/version/linkage, skips rebuilding, and repeats verification.
  • Hardware/BIOS/DIMM-layout readiness is accepted independently from successful compilation.
  • Human approval is recorded before replacing PR feat(ipmctl): add pinned Debian 13 source installer #1, merging, or publishing to www.

Until those boxes are satisfied, this PR is a candidate delivery vehicle, not a release claim.

@climateamante

Copy link
Copy Markdown
Contributor Author

Candidate automation checkpoint for commit f2b4122:

This run performed repository contracts and static-site assembly only. It did not compile ipmctl, install packages, access PMem hardware, or deploy the www branch.

Remote Debian 13 PMem-server build, second-install idempotence, and human review of all four read-only probes remain required before this candidate can replace PR #1 or merge.

@climateamante

Copy link
Copy Markdown
Contributor Author

Superseded by PR #1 after the reviewed f2b4122 candidate replaced feature/ipmctl in place. Static evidence and discussion continue there.

@climateamante
climateamante deleted the rewrite/ipmctl-simple branch August 2, 2026 05:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant